Installation Documentation

Welcome to Beloma

Beloma is a complete and robust solution developed to meet your needs. This documentation will guide you through the entire installation process, whether on a cPanel server or a dedicated VPS.

System License

To use the Beloma system, you need a valid license purchased through CodeCanyon. The license guarantees access to updates and technical support.

Server Dependencies

Before starting the installation, make sure your server meets the minimum requirements listed below. These requirements are essential for the system to work correctly.

General Requirements

• Node.js Version 18.x or higher (recommended: 20.x LTS)
• NPM Version 9.x or higher (included with Node.js)
• MySQL Version 8.0 or higher / MariaDB 10.5+
• PM2 Process manager for Node.js (installed globally)
• SSL/HTTPS Valid SSL certificate (required for WhatsApp API)
• RAM Memory Minimum 2GB (recommended: 4GB or more)
• Storage Minimum 20GB of free disk space

cPanel Requirements

For installation on servers with cPanel, verify that the following resources are available:

• cPanel/WHM Latest version with SSH access enabled
• Node.js Selector cPanel plugin to manage Node.js applications
• SSH Terminal SSH access enabled for your account
• MySQL Databases Permission to create MySQL databases
• SSL/TLS Let's Encrypt or SSL certificate installed
• Domain/Subdomain Domain or subdomain configured and pointing to the server

VPS Requirements

For VPS (Virtual Private Server) installation, you will have full control over the environment. We recommend the following specifications:

• Operating System Ubuntu 20.04/22.04 LTS or Debian 11/12 (recommended)
• Root Access Root access or user with sudo privileges
• CPU Minimum 2 vCPUs (recommended: 4 vCPUs)
• RAM Memory Minimum 2GB (recommended: 4GB or more)
• Nginx or Apache Web server for reverse proxy
• Firewall UFW or iptables configured (ports 80, 443, 22)

cPanel Installation

Follow the step-by-step guide below to install Beloma on your cPanel server:

# Node.js Application Settings
Node.js version: 20.x (or the latest available)
Application mode: Production
Application root: /home/username/public_html/beloma
Application URL: yourdomain.com
Application startup file: server.js

# Database Settings
DB_HOST=localhost
DB_USER=your_mysql_user
DB_PASS=your_mysql_password
DB_NAME=database_name

# Application Settings
NODE_ENV=production
APP_URL=https://yourdomain.com
PORT=3000

# Session Key (generate a random key)
SESSION_SECRET=your_secret_key_here

# Via SSH
cd ~/public_html/beloma
npm install --production

npm run migrate

npm start
# Or using PM2 to keep it running
pm2 start ecosystem.config.js

VPS Installation

Follow the step-by-step guide below to install Beloma on your VPS with Ubuntu/Debian:

sudo apt update && sudo apt upgrade -y

# Add NodeSource repository
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -

# Install Node.js
sudo apt install -y nodejs

# Verify installation
node --version
npm --version

# Install MySQL
sudo apt install -y mysql-server

# Configure MySQL security
sudo mysql_secure_installation

# Access MySQL and create database
sudo mysql -u root -p

# Inside MySQL:
CREATE DATABASE beloma_db;
CREATE USER 'beloma_user'@'localhost' IDENTIFIED BY 'your_strong_password';
GRANT ALL PRIVILEGES ON beloma_db.* TO 'beloma_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

sudo apt install -y nginx
sudo systemctl enable nginx
sudo systemctl start nginx

sudo npm install -g pm2

# Create directory
sudo mkdir -p /var/www/beloma
sudo chown -R $USER:$USER /var/www/beloma

# Upload via SCP (from your computer)
scp -r ./beloma/* user@your_ip:/var/www/beloma/

# Or clone via Git (if available)
cd /var/www/beloma
git clone your_repository .

cd /var/www/beloma
cp .env.example .env
nano .env

# Configure the variables:
DB_HOST=localhost
DB_USER=beloma_user
DB_PASS=your_strong_password
DB_NAME=beloma_db
NODE_ENV=production
APP_URL=https://yourdomain.com
PORT=3000
SESSION_SECRET=generate_a_random_key_here

cd /var/www/beloma
npm install --production
npm run migrate

sudo nano /etc/nginx/sites-available/beloma

# Paste the configuration:
server {
    listen 80;
    server_name yourdomain.com www.yourdomain.com;

    location / {
        proxy_pass http://localhost:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_cache_bypass $http_upgrade;
    }
}

# Enable the site
sudo ln -s /etc/nginx/sites-available/beloma /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d yourdomain.com -d www.yourdomain.com

# Configure automatic renewal
sudo certbot renew --dry-run

cd /var/www/beloma
pm2 start ecosystem.config.js

# Save PM2 configuration
pm2 save

# Configure to start on boot
pm2 startup

# Check status
pm2 status
pm2 logs

sudo ufw allow 22
sudo ufw allow 80
sudo ufw allow 443
sudo ufw enable
sudo ufw status

Technical Support

Our support team is ready to help you with any questions or issues related to the installation and use of the Beloma system.

Frequently Asked Questions (FAQ)